home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cato / Xm / XmInstallImage.z / XmInstallImage
Encoding:
Text File  |  2002-10-03  |  5.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmIIIInnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        XXXXmmmmIIIInnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmIIIInnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee - A pixmap caching function that adds an
  10.           image to the pixmap cache
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////XXXXmmmm....hhhh>>>>
  14.  
  15.           BBBBoooooooolllleeeeaaaannnn XXXXmmmmIIIInnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee ((((_i_m_a_g_e, _i_m_a_g_e__n_a_m_e))))
  16.                XXXXIIIImmmmaaaaggggeeee    * _i_m_a_g_e;;;;
  17.                cccchhhhaaaarrrr      * _i_m_a_g_e__n_a_m_e;;;;
  18.  
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents version 1.2 of the Motif library.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmIIIInnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee stores an image in an image cache that can
  25.           later be used to generate a pixmap.  Part of the
  26.           installation process is to extend the resource converter
  27.           used to reference these images.  The resource converter is
  28.           given the image name so that the image can be referenced in
  29.           a .Xdefaults file.  Since an image can be referenced by a
  30.           widget through its pixmap resources, it is up to the
  31.           application to ensure that the image is installed before the
  32.           widget is created.
  33.  
  34.  
  35.           _i_m_a_g_e     Points to the image structure to be installed.
  36.                     The installation process does not make a local
  37.                     copy of the image.  Therefore, the application
  38.                     should not destroy the image until it is
  39.                     uninstalled from the caching functions.
  40.  
  41.           _i_m_a_g_e__n_a_m_e
  42.                     Specifies a string that the application uses to
  43.                     name the image.  After installation, this name can
  44.                     be used in .Xdefaults for referencing the image.
  45.                     A local copy of the name is created by the image
  46.                     caching functions.
  47.  
  48.  
  49.           The image caching functions provide a set of eight
  50.           preinstalled images.  These names can be used within a
  51.           ....XXXXddddeeeeffffaaaauuuullllttttssss file for generating pixmaps for the resource for
  52.           which they are provided.
  53.  
  54.           IIIImmmmaaaaggggeeee NNNNaaaammmmeeee      DDDDeeeessssccccrrrriiiippppttttiiiioooonnnn
  55.           ____________________________________________________________
  56.           background      A tile of solid background
  57.           25_foreground   A tile of 25% foreground, 75% background
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmIIIInnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee((((3333XXXX))))        UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV        XXXXmmmmIIIInnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           50_foreground   A tile of 50% foreground, 50% background
  75.           75_foreground   A tile of 75% foreground, 25% background
  76.           horizontal      A tile of horizontal lines of the two colors
  77.           vertical        A tile of vertical lines of the two colors
  78.           slant_right     A tile of slanting lines of the two colors
  79.           slant_left      A tile of slanting lines of the two colors
  80.  
  81.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  82.           Returns True when successful; returns False if NULL _i_m_a_g_e,
  83.           NULL _i_m_a_g_e__n_a_m_e, or duplicate _i_m_a_g_e__n_a_m_e is used as a
  84.           parameter value.
  85.  
  86.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  87.           XXXXmmmmUUUUnnnniiiinnnnssssttttaaaallllllllIIIImmmmaaaaggggeeee((((3333XXXX)))), XXXXmmmmGGGGeeeettttPPPPiiiixxxxmmmmaaaapppp((((3333XXXX)))), and
  88.           XXXXmmmmDDDDeeeessssttttrrrrooooyyyyPPPPiiiixxxxmmmmaaaapppp((((3333XXXX)))).
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.